home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / science / sm32a.zip / SYMBMATH.H03 < prev    next >
Text File  |  1994-03-29  |  21KB  |  478 lines
  1.                 2.9  Editor and Edit help menu
  2.     SymbMath includes a multi-windowed text editor for creating 
  3. and modifying program files.  Usage of the editor is similar to 
  4. WordStar in nondocument mode, to Borland's SideKick, or to Borland's C
  5. compiler. 
  6.         You can execute the edit commands either by selecting the edit
  7. commands in the Edit Help menu or by keystrokes.
  8.  
  9.                2.9.1  Edit Help Menu
  10.         Open the Edit Help menu by pressing <F1> within the Input window,
  11. the Aux Edit window, or the Help window.
  12.     This menu has 11 choices:
  13.  
  14. ---------------------------
  15. | Show help file          |
  16. | Cursor movement         |
  17. | Insert & Delete         |
  18. | Searching               |
  19. | Block functions         |
  20. | Special block functions |
  21. | File functions          |
  22. | Application keys        |
  23. | Miscellaneous           |
  24. | Global functions        |
  25. | Hot keys                |
  26. ---------------------------
  27.  
  28. Except for the first choice of the "Show help file", others have their 
  29. own sub-menu. You can select the edit command in the sub-menu by the
  30. up or down key and <Enter>.
  31.  
  32.                      2.9.1.1 Show Help File
  33.         This command opens a help window to show a help file.
  34.  
  35.                      2.9.1.2  Cursor movement commands
  36.         This command opens a menu for cursor movement commands.
  37. The functionality of most of the cursor-movement commands is straight-
  38. forward. In this section, only the "non-obvious" commands will be 
  39. explained.
  40.  
  41. Scroll Up
  42. The text scrolls one line up. The cursor will be at same physical line on 
  43. the computer-screen.
  44.  
  45. Scroll Down
  46. The text scrolls one line down. The cursor will be at the same physical 
  47. line on the computer-screen.
  48.  
  49. Previous Position
  50. Moves the cursor to its position just prior to the last command. For 
  51. instance, if you inadvertently press Goto Texrstart, moving your cursor 
  52. to the top of the file, you can press Previous Position to get back to 
  53. where you were.
  54.  
  55. Goto Line 
  56. Moves the cursor to the line number you specify.
  57.  
  58. Goto Position 
  59. The position is the number of characters from the textstart. Newlines and 
  60. tabs ars both counted as one character.
  61.  
  62. Goto Blockstart
  63. Moves the cursor to the block-begin marker that you already have set with 
  64. Mark blockstart. The command works even if the block is not displayed (see
  65. "Hide/display block" under "Block Commands"), or if the block-end marker 
  66. is not set.
  67.  
  68. Goto Blockend
  69. Moves the cursor to the block-end marker that you have alread set with 
  70. Mark Blockend. The command works even if the block is not displayed (see 
  71. "Hide/desplay block") or the block-begin marker is not set.
  72.  
  73.               2.9.1.3  Insert and delete commands
  74.  
  75. To write a program, you need to know more than just how to move the cursor 
  76. around. You also need to be able to insert and delete text. The following 
  77. commands insert and delete characters, words, and lines. You can also 
  78. insert blocks of text from other files-- refer to "The Auxiliary Editor" 
  79. later in this chapter.
  80.  
  81. Insert line
  82. Inserts a line break at the cursor position.
  83.  
  84. Backspace - delete character left of cursor
  85. Moves one character to the left and deletes the character positioned there.
  86. Any characters to the right of the cursor move one position to the left.
  87. You can use this command to remove line breaks.
  88.  
  89. Delete character under cursor
  90. Deletes the character under the cursor and moves any characters to the right 
  91. of cursor one position to the left. This command works across line breaks, 
  92. and can be used to remove them.
  93.  
  94. Delete word right of cursor
  95. Deletes the word to the right of the cursor. A word is defined as a sequence
  96. of characters delimited by one of the following characters:
  97.     space < > , ; . ( ) [ ] ^  ' * + - / $
  98. This command does not work across line breaks. To undo a delete word press 
  99. Paste.
  100.  
  101. Delete from cursor to start of line
  102. Deletes all text from the cursor position to the beginning of the line. To
  103. undo this command press Paste.
  104.  
  105. Delete from cursor to end of  line
  106. Seletes all text from the cursor position to the end of the line. To undo 
  107. theis command press Paste.
  108.  
  109. Delete line
  110. Deletes the line cuontaining the cursor and moves any lines below one 
  111. line up. To undo a line delete, use Paste.
  112.  
  113.          2.9.1.4  Search and replace Commands
  114.  
  115. The editor supports search and replace commands that let you search for 
  116. strings in the tect and replace them with other strings. Replacement
  117. can optionally be prompted (ask yes/no at each replacement).
  118.  
  119. Search 
  120. Lets you search for a string of up to 45 characters. When you enter this 
  121. command, the status line is cleared, and the prompt
  122.     search text, text:
  123. appears at the bottom of the Edit window. Enter the string you are looking 
  124. for and then press Search again.
  125.  
  126. The search string can contain any characters, including control chatacters.
  127.  
  128. To quit the search operation, use the abort command <Esc>.
  129.  
  130. Search again
  131. Moves the cursor to the next occurrence of the last used search-string.
  132.  
  133. Replace
  134. This operation works identically to the Find command, except that you can 
  135. replace the "found" string with any other string of up to 45 characters. 
  136. First, enter the search string and press Replace, the editor prompts you 
  137. for the string that will replace the search string. Enter up to 45 
  138. characters, press Replace again.
  139.  
  140. The next prompt (prompt before replacing (y/n)) can be answered Yes or No: y 
  141. means you decide whether an occurrence of the string will be replaced, while 
  142. n means the editor will replace it automatically.
  143.  
  144. When the editor finds the items--and of the N option is not specified--it 
  145. then positions the cursor at the start of the item, and asks Replace Yes/
  146. No/Rest (y/n/r)? in the prompt line. You can abort the Find/Replace 
  147. operation at this point with the Abort command <Esc>. Press the Y-key and
  148. the word at the cursor will be replaced with the replace-string, and the 
  149. cursor moves to the next occurrence of the search string. Press the R-key 
  150. and this and all subsequent of the search-string on replaced automatically.
  151.  
  152. Replace again
  153. Finds the next occurrence of the last used search string and pompts for 
  154. replacement with the last used replace-string.
  155.  
  156. Wordstar Search and Replace commends
  157. These four commands is almost identical to the four descrobed above. The 
  158. only difference is that the user input is terminated with cr and not the
  159. command-keystroke. This means that it's not possible to search for
  160. newlines.
  161.  
  162.          2.9.1.5  Block Commands
  163.  
  164. A block of text is any amount of text, from a single character to hundreds
  165. of lines, that has beed surrounded with special block-marker characters. 
  166. You can only mark one block in a source text at a time.
  167.  
  168. Three diffenrent kinds of block-marking commands can be used in the editor, 
  169. and the commands are: WordStar-like block commands, MultiMate-like block 
  170. commands (The block commands introduced in version 1.x of the SymbMath 
  171. editor - ofter referred to as the "old" block commands) and Sprint-like 
  172. block commands. The overall concept for each of the three command-
  173. categories can be summarised as follows:
  174.  
  175. Sprint like commands
  176. Place the cursor at the beginning at the block - press Block select. Now move 
  177. the cursor to the bockend (the block will be highlighted as you go). When at 
  178. the blockend, select a function to be performed of the block.  The block can 
  179. be either moved or copied to the paste buffer. Later the content of the paste
  180. buffer can be pasted into the text with the Paste command.
  181.  
  182. Wordstar like commands
  183.  
  184. You mark a block by placing a block-begin marker before the first character 
  185. and a block-end marker after the last character of the desired portion of 
  186. text. Once the block is marked, you can copy, move, or delete it, or write
  187. it to a file.
  188.  
  189. Multimate like commands
  190. These commands works on the principle that you use the same key to begin
  191. and end a given operation. To abort any block command before it's completed
  192. (when it's waiting for input), just press Esc. For instance, to copy a block 
  193. using the block commands, you press MultiMate copy to start the process 
  194. (mark the block begin), use the arrow keys to highlight the block, then 
  195. press MultiMate copy again to mark the block end. After that, you move the 
  196. cursor to the position where the copy. If you want to insert multiple copies 
  197. of the marked block, you simply move the cursor with arrow keys to the new 
  198. location(s), then press Paste.
  199.  
  200. Block select
  201. When pressing the Block select command, you enter block markingg mode. The 
  202. block will be highlighted as you move (ahead or back from the starting 
  203. position). In block marking mode, no characters can be inserted. Pressing 
  204. a character key causes the cursor to move to the next occurrence of that 
  205. character, Quit block marking mode by pressing <Esc> of Block select again.
  206.  
  207. Copy block to paste buffer
  208. The currently marked block is copied to the paste beffer. The command 
  209. terminates block marking mode, and the previous content of the paste 
  210. buffer are overwritten. 
  211.  
  212. Move block to paste buffer
  213. The currently marked block is deleted from the text and moved to the 
  214. paste buffer. the command terminate blick marking mode, and the previous
  215. contents of the paste buffer are oberwritten.
  216.  
  217. Paste 
  218. The contents of the paste buffer are inserted in the text at the current 
  219. cursor podition. The paste buffer itself is not affected by the command.
  220.  
  221. Mark blockstart 
  222. Marks the beginning of a block. The marker itself is not visible, and the 
  223. block itself only becomes visible when the block-end marker is set. Marked 
  224. text a block is displayed with a different attribute than the unmarked 
  225. text (you can choose the attribute for unmarked text with the menu item
  226. Setup/ Colors/ Edit /Window /Normal Text).
  227.  
  228. Mark blockend 
  229. Marks the end of a block. The marker itself is invisible, and the block 
  230. itself becomes visible only when the block-begin marker is also set. 
  231. Pressing Mark blockend in block marking mode exit this mode. The block is 
  232. still highlighted.
  233.  
  234. WordStar show/hide block
  235. Causes the visual marking of a block to be alternately switched off and on. 
  236. The block manipulation commands copy, move, delete, and write to a file 
  237. work only when the block is displayed. Block-related cursor movements jump 
  238. to beginning/end of block works both when the block is hidden and displayed. 
  239.  
  240. WordStar copy block 
  241. Copies the currently marked block to the paste buffer and then pastes the 
  242. contents of the paste buffer at the current cursor position.
  243.  
  244. MultiMate copy block 
  245. Press MultiMate copy block to start the process mark the block begin, use 
  246. the arrow keys to highlight the block, then press MultiMate copy block 
  247. again to mark the block end. After that, you move the cursor to the 
  248. position where the copy is to be insertted, then press MultiMate copy 
  249. block once more to insert the copy. If you want to insert multiplw copies 
  250. of the marked block, you simply move the cursor with arrow keys to the new 
  251. locations, then press Paste.
  252.  
  253. MultiMate move block 
  254. Press MultiMate move block to start the process mark the block beginning, 
  255. use the arrow keys to highlight the block, then press MultiMate move block 
  256. again to mark the block end. After that, you press MultiMate move block 
  257. once more to move the block.
  258.  
  259. MultiMate delete block
  260. Press MultiMate delete block to start the process mark the block beginning, 
  261. use the arrow keys to highlight the block, then press Multimate delete block 
  262. again to delete the block.
  263.  
  264.          2.9.1.6  Special block commands
  265.  
  266. Copy block to printer
  267. Writes previously marked block to the printer. The block is left unchanged
  268. in the current file, and the markers remain in place. If no block is
  269. marked, nothing happens.
  270.  
  271. Copy block to file
  272. Writes a previously marked block to a file. the block is left unchanged
  273. in the current file, and the markers remain in place. If no block is
  274. marked, nothing happens.
  275.  
  276. Change case for block
  277.  
  278. Copy block from file
  279.  
  280.  
  281.                 2.9.1.10   Global Commands
  282. Resize window
  283. Move the window to a new position by holding down the <Shift> key and
  284. pressing the appropriate arrow key in the numeric keypad without Caps
  285. Lock.
  286. Change the size of a window by the arrow keys.
  287.  
  288. Zoom window
  289.  
  290. Previous line
  291.  
  292. File mask
  293. Press this cooamd when the filename browser in the file-name input box is
  294. active. You can then enter the file-mask (e.g. *.sm).
  295.  
  296.  
  297.                 2.9.2  Edit Commands
  298.     Within the Input window, press <F8> to open another window,
  299. called the Aux Edit window. In the Auxi Edit window, press <F8> again to
  300. open another Aux Edit window. So you can open many the Aux Edit windows 
  301. to edit many files.
  302.     Text in the Input window always be saved after exit by pressing
  303. <Esc>. The Aux Edit window is closed with saving by pressing <F10>, or 
  304. without saving by pressing <Esc>.
  305.     In the Input window or the Aux Edit window, press <F1> to pop-
  306. up the Edit Help menu (see 2.9.1 Edit Help Menu), or <Shift><F1> to see
  307. the manual, and <F7> to copy block from the an Aux Edit window into
  308. the main editor or into the last Aux Edit window.
  309.     Move the cursor around in the editor with the arrow
  310. keys, <Page Up>, <Page Down>, and some other keys listed below.  The
  311. editor has two typing modes: Insert and Overwrite.  In Insert
  312. mode, anything you type is inserted at the cursor position.  In
  313. Overwrite mode, pressing a key replaces the current character
  314. at the cursor position with the new typed character.  Initially,
  315. the editor operates in Insert mode, to switch modes, press the
  316. <Insert> key or <Ctrl>V.  (<Ctrl>V means to hold down the <Ctrl> key
  317. on your keyboard while you press V.  The V need not be in upper
  318. case.)
  319.     Unlike a more standard word processing program, the editor
  320. does not have word-wrap. You must press <Enter> at the end of each
  321. line.
  322.     The editor has an autoindent feature that allows subsequent
  323. lines to automatically indent.  If you leave several spaces at the
  324. start of a line, use <Ctrl>OI to indent subsequent lines the same
  325. amount.  The command sequence is a toggle, so you need only
  326. press <Ctrl>OI again to stop indenting.
  327.     Sometimes you may want to see more than the area covered by
  328. the current window.  You can zoom the window, expanding it to the
  329. size of the entire screen, by pressing <F5>.  To return the window
  330. to its usual size, press <F5> again.  For other window commands,
  331. such as moving and resizing a window, see the window command table, 
  332. below.
  333.  
  334.         The editor uses approximately 70 commands, which can be grouped
  335. into 6 main categories:
  336.      1. cursor movement commands
  337.      2. insert and delete commands
  338.      3. search and replace commands
  339.      4. file commands
  340.      5. block commands
  341.      6. miscellaneous commands
  342.  
  343.  
  344.       Table 2.9.1  Editor commands.
  345. ---------------------------------------------------------------
  346.   Cursor Movement Commands (move cursor to):
  347. .......................................................
  348.   Character left         <Ctrl>S  or Left arrow <-
  349.   Character right        <Ctrl>D  or Right arrow  ->
  350.   Word left              <Ctrl>A  or <Ctrl> <-
  351.   Word right             <Ctrl>F  or <Ctrl> ->
  352.   Line up                <Ctrl>E  or Up arrow
  353.   Line down              <Ctrl>X  or Down arrow
  354.   Scroll up              <Ctrl>W
  355.   Scroll down            <Ctrl>Z
  356.   Page up                <Ctrl>R  or <Pg Up>
  357.   Page down              <Ctrl>C  or <Pg Dn>
  358.   Beginning of line      <Ctrl>QS or <Home>
  359.   End of line            <Ctrl>QD or <End>
  360.   Top of screen          <Ctrl>QE or <Ctrl><Home>
  361.   Bottom of screen       <Ctrl>QX or <Ctrl><End>
  362.   Top of file            <Ctrl>QR or <Ctrl><Pg Up>
  363.   Bottom of file         <Ctrl>QC or <Ctrl><Pg Dn>
  364.   Beginning of block     <Ctrl>QB
  365.   End of block           <Ctrl>QK
  366.   Previous point         <Ctrl>QP
  367.   Marker 0               <Ctrl>Q0
  368.   Marker 1               <Ctrl>Q1
  369.   Marker 2               <Ctrl>Q2
  370.   Marker 3               <Ctrl>Q3
  371.   Set marker 0           <Ctrl>K0
  372.   Set marker 1           <Ctrl>K1
  373.   Set marker 2           <Ctrl>K2
  374.   Set marker 3           <Ctrl>K3
  375.  
  376. ...........................................................
  377.  
  378.   Insert & Delete Commands:
  379. ...........................................................
  380.   Insert mode on/off                 <Ctrl>V or <Ins>
  381.   Insert line                        <Ctrl>N
  382.   Delete line                        <Ctrl>Y
  383.   Delete to end of line              <Ctrl>QY
  384.   Delete left character              <Ctrl>H or <Backspace>
  385.   Delete character under cursor      <Ctrl>G or <Del>
  386.   Delete right word                  <Ctrl>T
  387.  
  388. ...........................................................
  389.  
  390.   Block commands:
  391. ............................................................
  392.   Block selec                     <Ctrl>KM
  393.   Copy block to pastebuffer       <Ctrl>KI                            
  394.   Move block to pastebuffer       <Ctrl>KY
  395.   Paste                           <Ctrl>U or <Ctrl><F7>                            
  396.   Mark block begin                <Ctrl>KB
  397.   Mark block end                  <Ctrl>KK
  398.   Mark word                       <Ctrl>KT
  399.   WordStar show/hide block        <Ctrl>KH
  400.   WoardStar copy block            <Ctrl>KC or <Ctrl><F5>
  401.   Repeat the last copy            <Shift><F5>
  402.   WordStar move block             <Ctrl>KV or <Alt><F6>
  403.   MultiMate copy block            <Ctrl><F5>
  404.   MultiMate move block            <Alt><F6>
  405.   MultiMate delete block          <Alt><F7>
  406.   Delete block                    <Ctrl>KY
  407.   Read block                      <Ctrl>KR or <F7>
  408.  
  409. .....................................................................
  410.  
  411.   Special Block functions
  412. ....................................................................
  413.   Copy block to printer           <Ctrl>KP or <Alt><F8>
  414.   Copy block to file              <Ctrl>KW or <Alt><F5>
  415.   Copy block from file            <Ctrl>KR or <F7>
  416.   Change case for block           <Ctrl>KE or <Ctrl><F6>
  417. .....................................................................
  418.  
  419.   Miscellaneous Commands:
  420. .....................................................................
  421.   Quit edit                     <Esc>, <F10>, <Ctrl>KD, or <Ctrl>KQ
  422.   Call the auxiliary editor     <F8>
  423.   Tab                           <Ctrl>I  or <Tab>
  424.   Tab mode toggle               <Ctrl>OT
  425.   Auto indent on/off            <Ctrl>OI
  426.   Restore line                  <Ctrl>QL
  427.   Find                          <Ctrl>QF or <Ctrl><F3>
  428.   Repeat last find              <Ctrl>L  or <Shift><F3>
  429.   Find & replace                <Ctrl>QA or <Ctrl><F4>
  430.   Repeat last find & replace    <Ctrl>L  or <Shift><F4>
  431.   Control key prefix            <Ctrl>P
  432.   Abort operation               <Ctrl>U
  433.   Restore error message         <Ctrl>QW
  434.  
  435.   Search Options:
  436.  
  437.   L           Local search
  438.   G           Global search
  439.   N           Replace without asking
  440.   Y           Replace with asking
  441.  
  442. ...................................................................
  443.  
  444.   Global Commands
  445. ...................................................................
  446.   Resize window                 <Shift><F10>
  447.   Zoom window                   <F5>
  448.   Previous line                 <F8>
  449.   File mask                     <F4>
  450.   Terminate input               <F10>
  451. ------------------------------------------------------------------
  452.  
  453.  
  454.     Table 2.9.2   Edit window commands
  455. ---------------------------------------------------------------------
  456. Action                                     Key
  457.  
  458. help                                       <F1>
  459. zoom in window                             <F5>
  460. zoom out window                            <F5>
  461. resize window                              <Shift><F10>, the -><- keys, <F10>
  462. move window                                <Shift><F10>, <Shift> and the
  463.                                            arrow key in numeric keypad
  464.                                            without Caps Lock
  465. open an Aux Edit window                    <F8>
  466. close the Aux Edit window with saving      <F10>
  467. close the Aux Edit window without saving   <Esc>
  468. block copy from an Aux Edit window         <F7>
  469. ---------------------------------------------------------------------
  470.  
  471.     The content of the status line 
  472.  
  473. --------------------------------------------------------------------------
  474. F1 Help, F2 Save, F3 Open, F4 Replace, F5 Zoom, F7 XCopy, F8 XEdit, F10 End
  475. --------------------------------------------------------------------------
  476.  
  477. indicates that to press <F1> key to get help.
  478.